home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / acnfn14.zip / ACNFN.DOC < prev    next >
Text File  |  1992-06-24  |  12KB  |  312 lines
  1.              Automated Network/Conference Listing Generator
  2.  
  3.                                   v1.4
  4.  
  5.                               PCBoard 14.5a
  6.  
  7.                                    by
  8.  
  9.                               Al Lawrence
  10.  
  11.                             Sunrise-80  BBS
  12.                             (404) 256-9525
  13.  
  14.  
  15.  
  16.  
  17.                               DESCRIPTION
  18.                               ___________
  19.  
  20.  
  21. The Automated Network/Conference Listing Generator (ACNFN) is a utility that 
  22. creates the conference display file. Most Sysops use an editor to create the
  23. conference listing, more commonly called CNFN. As you add/change/delete 
  24. conferences you end up spending hours trying to realign and colorize the 
  25. display. If you happen to add a whole network, you could very well spend 
  26. more time fixing the conference listing, than creating the conferences 
  27. themselves. This utility does not create any extraneous files on disk and 
  28. uses the CNAMES file as input. There is no need to create a second file for 
  29. the colorized listing, as the program uses the @X variables made available
  30. in PCBoard v14.5. Just about everything is configurable, from verbage to colors.
  31.  
  32.  
  33.  
  34.                               INSTALLATION
  35.                               ____________
  36.  
  37.  
  38.    Installation is fairly easy and straight-forward. The following steps and
  39.    examples should have you up and running in a very short period of time.
  40.    
  41.      (1) Create a Configuration file with a name of your choice.
  42.      
  43.          NOTE: BRUN45.EXE is not included but is required !!!
  44.  
  45.      (2) Run the program using the following command line:
  46.            
  47.                ACNFN   xxxx.CFG
  48.  
  49.          Where xxxx = the name used in (1) above.
  50.  
  51.  
  52.  
  53.  
  54.                              CONFIGURATION FILE
  55.                              __________________
  56.  
  57.      Line 1.   Sunrise-80 BBS
  58.      Line 2.   Al Lawrence
  59.      Line 3.   00000000
  60.      Line 4.   INPUT=C:\PCB\MAIN\CNAMES
  61.      Line 5.   OUTPUT=C:\PCB\GEN\CNFN
  62.      Line 6.   SORT=N
  63.      Line 7.   NUMCOL=LEFT
  64.      LINE 8.   NDESC=RIM:RIME
  65.      Line 9.   NETCONF=RIM:2:100:P
  66.      Line 10.  CONF=LOC:Sunrise Doors:1:1:p
  67.      Line 11.  XCNF=@X06
  68.      Line 12.  XTYP=@X0C
  69.      Line 13.  XCFN=@X0A
  70.      Line 14.  XHDB=@X1A
  71.      Line 15.  XBBS=@X1F
  72.      Line 16.  XNET=@X57
  73.      Line 17.  XBBG=@X1F
  74.      Line 18.  XMRE=@X8C
  75.      Line 19.  BLINE=R = Restricted
  76.  
  77.  
  78.  
  79. __________________________________________________________________________
  80.  
  81. Line 1.  Your BBS Name. Will Display on Heading and is mandatory
  82.  
  83. Line 2.  Sysop's First and Last Name. Does not display, but is mandatory.
  84.  
  85. Line 3.  Registration Number
  86.  
  87. Line 4.  Full Pathname\Filename of the CNAMES file. This entry is 
  88.          mandatory.
  89.  
  90. Line 5.  Full Pathname\Filename of the output file that will contain
  91.          the conference listing. This entry is mandatory. 
  92.  
  93. Line 6.  This entry indicates the SORT sequence for the conference displays.
  94.          N = Display conference's in conference NUMBER sequence.
  95.          A = Display conference's in conference NAME sequence.
  96.          This entry is mandatory.
  97.  
  98. Line 7.  This entry indicates where you would like to have the conference 
  99.          number displayed. 
  100.          LEFT  = Display it to the LEFT  of the conference name 
  101.          RIGHT = Display it to the RIGHT of the conference name.
  102.          This entry is mandatory.
  103.  
  104. Line 8.  This entry assigns a UNIQUE 3 character ID and description to each 
  105.          Network on your system. The format is|  NETWORK ID:NETWORK NAME
  106.          The Network name will appear in the header, displayed at the top of
  107.          each column of the listing for that network. One NDESC entry is
  108.          required for EACH Network you carry. The maximum size of the Network
  109.          Name is 17 characters. The program will support an Unlimited number 
  110.          of Networks. At least one is mandatory
  111.  
  112. Line 9.  This entry describes the conference numbers to be associated with
  113.          each of the conference descriptions you have defined above. At 
  114.          least one is mandatory.
  115.        
  116.          Format|  NETWORK ID:STARTING CONF. #:ENDING CONF. #:CONF. TYPE
  117.          NETWORK ID = Must match one of the IDs in line 8.
  118.          STARTING # = First conference # in a range comprising the network         
  119.          ENDING   # = Last  conference # in a range comprising the network
  120.          CONF. TYPE = P for Public Conferences, R for Restricted/Reserved
  121.                       Note: This applies to ALL the conference numbers in the
  122.                             range indicated. 
  123.         
  124.          Use multiple NETCONF entries if you have a mixture of Public and
  125.          Reserved. For example: if your RIME conferences covered numbers
  126.          1-100 and #35-37 were Reserved and all others were Public you would 
  127.          use 3 NETCONF entries. 1-34 would have a CONF TYPE of P, 35-37 would
  128.          have a CONF TYPE of R and 38-100 would have a CONF TYPE of P. You can
  129.          use any number of NETCONF entries to fully describe your conference.
  130.          
  131.  
  132. Line 10. This entry is used to assign a conference to more than one NETWORK.
  133.          This is mostly cosmetic and is NOT a required entry. In future 
  134.          versions this entry will be used by non-PCBoard systems. Optional.
  135.          Format| NETWORK ID:CON. NAME:CONF. #:CONF. TYPE
  136.          NETWORK ID = Must match one of the IDs in line 8.
  137.          CON. NAME  = Conference name up to a maximum of 13 characters
  138.          CONF. #    = Conference number up 3 digits
  139.          CONF. TYPE = Same as Line 9 above
  140.  
  141. -------------------------------------------------------------------------
  142. --- Next 8 Entries Control the Colors For Each Section of the Listing ---
  143. ---------------------- Uses @X Color Codes ------------------------------
  144. -------------------- Registered Version Only ----------------------------
  145. -------------------------------------------------------------------------
  146.  
  147. Line 11. Conference Name Color
  148. Line 12. Conference Type Color
  149. Line 13. Conference Number Color
  150. Line 14. Heading Color (box)
  151. Line 15. Heading BBS Name Color
  152. Line 16. Network Name Color
  153. Line 17. Bottom Line Color
  154. Line 18. "More" Color, on Bottom line (both ends)
  155.  
  156. Line 19. With this entry you can define what appears on the bottom line.
  157.          By default it will show "R = Restricted", in registered version.
  158.          Maximum length is 70 characters. Optional. Requires Registration!
  159.  
  160.  
  161.  
  162.  
  163. __________________________ E X A M P L E ____________________________________
  164. To help make all this a little clearer (it is really very simple), I will 
  165. describe the conferences/Networks of my BBS and what the Configuration file 
  166. would look like. Sunrise-80 BBS has 4 Networks and Local conferences. The 
  167. Networks are RIME, City2City, SmartNet and L&Lnet. Conference numbers are 
  168. assigned as follows:
  169.  
  170.            Rime     : 2-23, 25-70, 94 (all are Public except 29,30,35)
  171.            City2City: 73-93 (all are Public except 75,84,86)
  172.            FidoNet  : 1, 71-72, 95-97 (all are Public)
  173.            SmartNet : 98-112 (all are Public)
  174.            Local    : 0, 24 (all are Public)
  175.  
  176. In addition I display my Sunrise Doors conference (conf # 1) in Local area 
  177. as well as the FidoNet Network.
  178.  
  179. I also use all the default colors and a special bottom line. All has been
  180. included in the example CFG.
  181.  
  182. The CNFN.CFG file would look like this:
  183. _______________________________________
  184.  
  185. Sunrise-80 BBS
  186. Al Lawrence
  187. 00000000
  188. INPUT=C:\PCB\MAIN\CNAMES.@@@
  189. OUTPUT=C:\PCB\GEN\CNFN
  190. SORT=N
  191. NUMCOL=LEFT
  192. NDESC=100:R I M E
  193. NDESC=200:City2City
  194. NDESC=400:FidoNet
  195. NDESC=300:SmartNet
  196. NDESC=500:L O C A L
  197. NETCONF=200:73:74:P
  198. NETCONF=200:75:75:r
  199. NETCONF=200:76:83:p
  200. NETCONF=200:84:84:r
  201. NETCONF=200:85:85:p
  202. NETCONF=200:86:86:r
  203. NETCONF=200:87:93:p
  204. NETCONF=100:2:23:p
  205. NETCONF=100:25:28:p
  206. NETCONF=100:29:30:r
  207. NETCONF=100:31:34:p
  208. NETCONF=100:35:35:r
  209. NETCONF=100:36:70:p
  210. NETCONF=100:94:94:p
  211. NETCONF=400:1:1:p
  212. NETCONF=400:71:72:p
  213. NETCONF=400:95:97:p
  214. NETCONF=500:0:0:p
  215. NETCONF=500:24:24:p
  216. NETCONF=300:98:112:P
  217. CONF=500:Sunrise Doors:1:p
  218. XCNF=@X06
  219. XTYP=@X07
  220. XCFN=@X0A
  221. XHDB=@X1A
  222. XBBS=@X1F
  223. XNET=@X57
  224. XBBG=@X1F
  225. XMRE=@X8C
  226. BLINE=R = Restricted    [AVAILABLE FROM: Sunrise Doors/Utility Software]
  227.  
  228.  
  229.                         Hints/Tips/Other Ramblings
  230.                         __________________________
  231.  
  232.      (1) The sequence in which the networks appear, is controlled by the
  233.          NETWORK ID field. The program will sort on this field, therefore
  234.          it is important to assign values to each network that will place
  235.          them in the proper sequence. As you can see from the Example 
  236.          Sunrise CFG file, above, I use 3 digit numbers.
  237.  
  238.      (2) The first three(3) entries in the CFG file are required to be in
  239.          that sequence. All others may be in any sequence.
  240.  
  241.      (3) This version will handle up to 9999 conferences. Future versions
  242.          will go higher but the number of conferences displayed across the 
  243.          screen will be reduced to 3... (can't stretch the screen :) )
  244.  
  245.      (4) Be sure to use the ':' to separate fields within each Entry.
  246.  
  247.      (5) I really do not like to do documentation and therefore there may be
  248.          some errors or omissions in this document. I would appreciate any 
  249.          feedback you wish to give relative to the program itself or the Docs.
  250.  
  251.  
  252.                               LEGALITIES
  253.                               __________
  254.  
  255.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  256.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  257.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  258.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  259.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  260.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  261.       OR BREACH OF ANY WARRANTY.
  262.  
  263.  
  264.  
  265.  
  266.  
  267.                              DISTRIBUTION
  268.                              ____________
  269.  
  270.    You may make this file available for downloading from your BBS or you may
  271.    upload it to any BBS of your choice, provided that you do not make any
  272.    changes to the contents of the archive (ZIP file). The archive and its
  273.    individual contents may not be used by any service that charges any money
  274.    whatsoever, without the written permission of the author.
  275.  
  276.  
  277.  
  278.  
  279.  
  280.                              REGISTRATION
  281.                              ____________
  282.  
  283.    Registration and the subsequent insertion of the registration number into
  284.    your configuation file, allows for the display of your BBS name on the
  285.    opening screenand its display in the heading of the listing, reduction of 
  286.    delays, and the ability to change certain values in the configuration file.
  287.  
  288.    To register your copy of ACNFN, please fill out the registration form
  289.    (REGISTER.FRM) and mail it along with a small donation ($20) to the name
  290.    and address on the form.
  291.  
  292.    Be sure to use the proper upper/lower case when filling in your name and
  293.    BBS name, as they MUST match the way you entered them in the configuration
  294.    file.             ^^^^
  295.  
  296.    Based upon information supplied on the registration form, I will pre-
  297.    register you on my BBS. You will then be able to call SUNRISE-80 and pick
  298.    up your registration number.
  299.  
  300.  
  301.  
  302.                                  MISC
  303.                                  ____
  304.  
  305.    The latest version of ACNFN and other fine SUNRISE DOOR programs are 
  306.    always available for download from SUNRISE-80 BBS.
  307.  
  308.    Remember, should you have any problems, questions or suggestions, be sure
  309.    to drop me a message on Sunrise-80 or in the RIME network (BBS_Doors, 
  310.    PCBHints, SYSops), SmartNet (SN_Sysops), City2City, FIDO (Sysops,
  311.    PCBnet, Sysop18), DoorNet or GeniusNet
  312.